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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Scope 



The present stage 3 specification defines the Diameter based implementation for bootstrapping Zh interface (BSF-HSS) 
and Dz interface (BSF-SLF) for HSS resolution for the BSF, and GAA Application Zn interface (BSF-NAF) in Generic 
Authentication Architecture (GAA). This specification also defines the Web Services based implementation for GAA 
Application Zn reference point (BSF-NAF). The definition contains procedures, message contents and coding. The 
procedures for bootstrapping and usage of bootstrapped security association are defined in 3GPP TS 33.220 [5]. 

This specification is a part of the Generic Authentication Architecture (GAA) specification series. 

The diameter based implementation is based on re-usage of Cx interface Multimedia- Auth-Request/Answer messages 
originally between CSCF and HSS. These messages are defined in 3GPP TS 29.229 [3]. The 3GPP IMS mobility 
management uses the same definitions between CSCF and HSS. The present document defines how the defined 
messages are used with the bootstrapping and GAA application procedures (e.g. subscriber certificates) and the 
application logic that is needed in GAA network elements (BSF, HSS, and NAF). 
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Figure 1 . 1 depicts the relationships of these specifications to the other specifications. 
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Figure 1 .1 : Relationships to other specifications 

Figure 1.2 provides an informal overall quick introduction to the whole signalling procedures in GAA system. The 
important identifiers are marked bold and optional data items are italicised. The Ub and Ua interfaces, not defined in 
this TS , are simplified. 
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3 Definitions, symbols and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 23.008 [10], 3GPP TR 33.919 
[4], 3GPP TS 33.220 [5] apply with following additions. 

Bootstrapping information (Bootstrapped data) in a BSF consists of a bootstrapping transaction identifier (B-TID), a key 
material (Ks), the key lifetime (expiry time), the boostrapinfo creation time, the IMPl and the GUSS (if received from HSS) 
with BSF control information. Each bootstrapping procedure creates a bootstrapped data entity with B-TID as retrieval 
key.. 

GAA application is an application that uses the security association created by GBA Bootstrapping procedure. 

GAA service is an operator specific end user service that uses the security association created by GAA Bootstrapping 
procedure. GAA services are identified by GAA Service Identifiers. A GAA service is implemented using some 
standardised or propriatary GAA application defined by GAA application type. 

NAF specific Bootstrapping information transferred from a BSF to a NAF contains NAF and its service specific parts 
from bootstrapped data and needed key information derived from the bootstrapped data. 

Service/Application. The term service is used here in its common meaning. A service is something that a MNO offers 
to subscribers. GAA Services are identified by GAA Service Identifier (GSID). In stage 2 documents ([4], [5], [6] and 
[11]) the term application is used in the same meaning i.e. MNOs offer applications to subscribers. There is a reason to 
avoid the usage of the term application here. The application is an already reserved term in Diameter. In Diameter 
applications are identified by Application Identifiers. 

3.2 Symbols 

For the purposes of the present document, the terms and definitions given in 3GPP TS 23.008 [10]. 

3.3 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

AK Anonymity Key 

AKA Authentication and Key Agreement 

AUTN Authentication token 

AV Authentication Vector. 3GPP AV=[RAND,AUTN,XRES,CK,IK]. 

AVP Attribute-Value-Pair in Diameter messages. 

BIA Bootstrappinglnfo- Answer message 

BIR Bootstrappinglnfo-Request message 

BS Bootstrapping Procedure 

BSF Bootstrapping server functionality 

BSF is hosted in a network element under the control of an MNO. 

B-TlD Bootstrapping Transaction Identifier 

CA Certificate Authority 

CK Confidential Key 

FQDN Full Qualified Domain Name in URI (e.g. http://FODN:80) 

GAA Generic Authentication Architecture 

GBA Generic Bootstrapping Architecture 

GSID GAA Service Identifier 

GUSS GBA User Security Settings 

HSS Home Subscriber System 

IK Integrity Key 

IMPI IP Multimedia Private Identity 

IMPU IP Multimedia PubUc Identity 

Ks Key Material 
Ks_ext_NAF MEbased key for a specific NAF 

MNO Mobile network operator 
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NAF Operator-controlled network application function functionality. 

NAF is hosted in a network element under the control of an MNO. 

RAND Random challenge in authentication 

REQ In Diameter header indicates that the message is a Request. 

SCTP Stream Control Transmission Protocol 

SLF Subscription Location Function 

SSC Subscriber Certificate Procedure 

Ua UE-NAF interface for GAA applications 

Ub UE-BSF interface for bootstrapping 

UE User Equipment 
Ks_int_NAF UICC based key for a specific NAF 

USS User Security Settings (a part of GUSS) 

XRES Expected response in authentication 

Zh BSF-HSS interface for bootstrapping procedure 

Zn BSF-NAF interface for GAA applications. 
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4 GBA Bootstrapping Zh interface 

4.1 Generic bootstrapping network architecture 

The network architecture of the Bootstrapping procedure is presented in Figure 4. 1 . The interface Ub (bootstrapping) is 
defined in 3GPP TS 24.109 [7] and the interface Zh in this specification. 



UE -Ub- BSF -Zh 



HSS 



Figure 4.1 : Network architecture of bootstrapping procedure 

The protocol stack of the Zh interface in Bootstrapping procedure is presented in Figure 4.2. The Diameter Base 
protocol is defined in [1] and the Diameter application in 3GPP TS 29.229 [3]. The requirements for Zh interface are 
defined in 3GPP TS 33.220 [5]. 
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Figure 4.2: Protocol stacl< of Zh interface 



4.2 



Protocol Zh between BSF and HSS 



The requirements for Zh interface are defined in 3GPP TS 33.220 [5]. 

The Bootstrapping Zh interface performs the retrieval of an authentication vector and possibly GBA User Security 
Settings from the HSS. The overall Bootstrapping procedure is depicted in Figure 4.3. The basic procedure is: 

A) A UE starts the bootstrapping procedure by protocol Ub with a BSF giving the IMPl of the user (see 3GPP TS 
24.109 [7]). 

B) The BSF starts protocol Zh with user"s HSS 

• The BSF requests user"s authentication vector and GBA User Security Settings(GUSS) corresponding to 
the IMPL 

• The HSS supplies to the BSF the requested authentication vector and GUSS (if any). 

NOTE: If there is more than one HSS deployed within the network, the BSF may have to contact the SLF using 
the Dz interface prior to sending the request for information to the HSS (see section 6.4). 

C) The BSF continues the protocol Ub with the UE (see 3GPP TS 24.109 [7]). 
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Figure 4.3: The GBA bootstrapping procedure 



The steps of the bootstrapping procedure in Figure 4.3 are: 

Stepl 

The BSF shall send the following Bootstrapping-Request to the HSS in the format of Multimedia-Auth-Request (MAR) 
message. The content of the message is given below in the same format as in 3GPP TS 29.229 [3]. The curly brackets 
indicate mandatory AVPs. The square brackets indicate optional AVPs. The "address of refers to the Fully Qualified 
Host Name (FQDN). 

=<Diameter Header: 303, REQ, PXY, 16777221 > 



<Multimedia-Auth-Request> 

< Session-Id > 

{ Vendor-Specif ic-Application-Id 

{ Auth-Session-State } 

{ Origin-Host } 

{ Origin-Realm } 

{ Destination-Realm } 

[ Destination-Host ] 

{ User-Name } 

[ GUSS-Timestamp ] 

* [ AVP ] 

* [ Proxy- Info ] 

* [ Route-Record ] 



NO_STATE_iyLAINTAINED 

Address of BSF 

Realm of BSF 

Realm of HSS 

Address of the HSS 

IMPI from UE 

Timestamp of GUSS in BSF 



The content of mandatory Vendor-Specific-Application-ID according [1] is: 

<Vendor-Specif ic-Application-Id> : : =<AVP header: 260> 
1* [Vendor-Id] 
0*1 {Auth-Application-Id} 
0*1 {Acct-Application-Id} 



3GPP is 10415 

16777221 

Omitted 



ETSI 



3GPP TS 29.1 09 version 7.6.0 Release 7 1 3 ETSI TS 1 29 1 09 V7.6.0 (2007-06) 

When determining the value of Destination-Host AVP the BSF can use redirector function (SLF) to resolve the address 
of the HSS if needed (see 3GPP TS 29.229 [3]). The BSF shall set the Auth-Session-State AVP to 
NO_STATE_MAINTAINED to inform that the HSS does not need to maintain any status information for this session 
according 3GPP TS 29.229 [3]. The User-name is the IMS Private User Identity (IMPI) as required in 3GPP TS 29.228 
[2]. If the BSF supports the GUSS timestamp mechanism and has local copy of the GUSS, which has a timestamp, the 
BSF may include the GUSS-Timestamp AVP. In this case the GUSS-Timestamp AVP shall contain the timestamp from 
subscriber's GUSS. Otherwise the GUSS-Timestamp AVP shall not be present. 

Step 2 

When the HSS receives the MAR message, the HSS shall derive the user Authentication Vector (AV) information 
according the IMPI and populates it into SIP-Auth-Data AVP as defined in 3GPP TS 29.229 [3]. If GUSS exists for the 
IMPI, the HSS shall do one of the following: 

1. If the HSS supports the GUSS timestamp mechanism and received the GUSS-Timestamp AVP in MAR 
message then it shall compare the timestamp of the GUSS in the HSS with the received timestamp. 

If timestamps are equal, then it shall populate the GBA-UserSecSettings AVP with static string "GUSS 
TIMESTAMP EQUAL". 

If the GUSS-Timestamp AVP was not received, or timestamps are not equal, then it shall populate the GB A- 
UserSecSettings AVP with the GUSS. 

2. If the HSS does not support GUSS timestamp mechanism, it shall populate the GBA-UserSecSettings AVP with 
the GUSS. 



The MAR/MAA sequence in the Zh interface must not change possible status information of the possible 
simultaneously ongoing IMS MM application sessions in the HSS. 

If the User-Name (IMPI) from the BSF is totally unknown to the HSS, the error situation 5401 is raised. 

Step 3 

The HSS shall send the following Bootstrapping-Answer message in the format of Multimedia- Auth- Answer (MAA) 
message back to the BSF. 

< Multimedia-Auth-Answer> ::= < Diameter Header: 303, PXY, 16777221 > 
< Session-Id > 

{ Vendor-Specif ic-Application-Id } 
[ Result-Code ] 
[ Experimental-Result] 
{ Auth-Session-State } 
{ Origin-Host } 
{ Origin-Realm } 
[ User-Name ] 
[ SIP-Auth-Data-Item ] 

[ GBA-UserSecSettings ] ; GUSS 

* [ AVP ] 
* [ Proxy- Info ] 
* [ Route-Record ] 



NO_STATE_MAINTAINED 
Address of HSS 
Realm of HSS 
IMPI 



The HSS shall set the mandatory Auth-Session-State AVP to NO_STATE_MAINTAINED because the HSS does not 
maintain any state information about this session and the BSF does not need to send any session termination request 
3GPP TS 29.229 [3]. The User-name AVP (IMPI) may be sent back for checking. The required authentication vectors 
are sent in the SIP-Auth-Data-Items AVP according to 3GPP TS 29.228 [2]. The security settings of user"s all GAA 
applications are sent in GBA-UserSecSettings AVP. 

If the 2G GBA option (see 3GPP TS 33.220, Annex I [5]) is appHed for the user the SIP-Auth-Data-Item AVP shall be 
filled as follows: The SIP-Authentication-Scheme AVP is set to "Digest- AKAvl-MD5-2G-GB A" to indicate a 2G GBA 
vector for GBA. The SIP- Authenticate AVP contains only RAND. The SIP- Authorization AVP contains RES. The 
Confidentiality-Key AVP contains Kc. The Integrity-Key AVP shall not be present. 
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Step 4. 

When the BSF receives the MAA message, the BSF shall check the value of the SIP- Authentication-Scheme AVP. If 
the BSF does not support the authentication-scheme the BSF shall stop processing the message and should indicate an 
error via the O&M subsystem. 

The BSF generates the needed key material (Ks) from confidential key (CK) and integrity key (IK) as described in 
3GPP TS 33.220 [5] and stores temporarily the tuple <IMPI,Ks,GBA-UserSecSettings> for further use in GAA 
applications. The rest of the bootstrapping procedure in Ub interface will later add also the Bootstrapping Transaction 
Identifier (B-TID) to that tuple as key and the key lifetime (expiry time). If the BSF sent the GUSS-Timestamp AVP in 
step 1, and if the GBA-UserSecSettings AVP contains a static string "GUSS TIMESTAMP EQUAL", then the local 
copy of the GUSS in the BSF shall be preserved. If the GBA-UserSecSettings AVP was not present in the MAA 
message, the local copy of the GUSS shall be deleted. If the GBA-UserSecSettings AVP contains a new GUSS, the 
local copy of the GUSS shall be deleted, and the new GUSS shall be stored in the BSF. 
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5 GAA Application Zn interface 

5.1 Applications" network architecture 

The network architecture of the GAA applications procedure is presented in Figure 5.1. The 3GPP GAA applications 
are listed in annex B. Different GAA applications may implement the Ua interface in different way. The Zn interface is 
defined in this specification. 



UE 



— Ua— NAF — Zn— BSF 



Figure 5.1 : Network architecture of GAA application 

Two options are specified for the protocol stack to be used on the Zn interface; 

The protocol stack of the DIAMETER based Zn interface, 

the protocol stack of the Web Services based Zn interface. 

The BSF shall support both options whereas the NAF shall support one or both of these options. 

The protocol stack of the Diameter based implementation of the Zn interface for GAA applications is presented in Figure 
5.2, and specified in clause 5.2. The diameter Base protocol is defined in [1] and the Diameter application in 3GPP TS 
29.229 [3]. The requirements for Zn interface are defined in 3GPP TS 33.220 [5]. 
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Figure 5.2: Protocol stack of Diameter based Zn interface 

The protocol stack of the Web Services based Zn interface for GAA applications is presented in Figure 5.2a, and specified 
in clause 5.3. 
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Figure 5.2a: Protocol stack of Web Services based Zn interface 



5.2 



Protocol Zn between NAF and BSF based on Diameter 



The requirements for Zn interface are defined in 3GPP TS 33.220 [5]. 

The protocol Zn retrieves the key material and possibly user security settings data by NAF from BSF. After UE is 
authenticated with the BSF, every time the UE wants to interact with an NAF the following steps are executed as 
depicted in Figure 5.3. The basic procedure is: 

A) The UE starts protocol Ua (see 3GPP TS 33.220 [5]) 

• In general, the UE and the NAF will not yet share the key(s) required to protect protocol Ua. If they already 
do, there is no need for the NAF to invoke protocol Zn. 

• It is assumed that UE supplies sufficient information to NAF, i.e. the Bootstrapping Transaction Identifier 
(B-TID), to allow the NAF to retrieve specific key material (e.g. Ks_NAF in the case of GBA_ME, and 
Ks_ext_NAF or Ks_int_NAF or both in the case of GB A_U) from BSF. 

• The UE derives the keys required to protect protocol Ua from the key material. 

B) The NAF starts protocol Zn with BSF 

• The NAF requests NAF specific key material corresponding to the information supplied by the UE to the 
NAF (i.e. the bootstrapping transaction identifier) in the start of protocol Ua. 

• The BSF generates and supplies to the NAF the requested NAF specific key material, the expiry time, the 
bootstrapinfo creation time, and the appropriate User Security Settings defined for received application 
identifiers. 

C) The NAF continues protocol Ua with the UE (see 3GPP TS 33.221 [6]) 

Once the run of protocol Ua is completed the purpose of bootstrapping is fulfilled as it enabled UE and NAF to run 
protocol Ua in a secure way. 

The common GAA application procedure is presented in Figure 5.3. 
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UE ua NAF 



UE knows: 
< B-TID. Ks> 



Zn 



BSF 



{ a security association 
created by bootstrapping } 



BSF has tuple: 
< B-TID. /MP/.Ks. 
ME-Ks, UICC-Ks,GUSS> 



UE start tine GAA application procedure 
by sending a B-TID. 



GUSS is 

GBA User Security Settings. 

GSID is 

GAA Service Indentifier. 



1 . Bootstrapping-lnfo-Request 



( B-TID, GSID*, NAF-ld) 



2. BSF checks the B-TID 

and derives 
ME-Key and UlCC-Key 



UE and NAF mutually authenticate 
each others using ME-Ks 



3. Bootstrapping-lnfo-Answer 

( IMPI, Key-ExpiryTlme, 

Ks_(ext)_NAF, /<s_/nLA//\F, 

BootstraplnfoCreationTlme, 

UserSecSetting* ) 



Figure 5.3: The Diameter based GAA application procedure 



The steps of the GAA application procedure in Figure 5.3 are: 



Step 1 



The NAF shall send a Bootstrapping-lnfo-Request message (BIR) to the BSF. The content of the message is 
given here in the same format as in 3GPP TS 29.229 [3]. The curly brackets indicate mandatory AVPs. The 
square brackets indicate optional AVP. The address refers to the Fully Quahfied Host Name (FQDN). 



< Bootstrapping- Info-Request> 



=<Diameter Header: 310, REQ, PXY, 16777220 > 



< Session-Id > 

{ Vendor-Specif ic-Application-Id 

{ Origin-Host } 

{ Origin-Realm } 

{ Destination-Realm } 

[ Destination-Host ] 

* [ GAA-Service-Identif ier ] 

{ Transaction-Identifier } 

{ NAF- Id } 

[ GBA_U-Awareness- Indicator ] 

* [ AVP ] 

* [ Proxy- Info ] 

* [ Route-Record ] 



Address of NAF 

Realm of NAF 

Realm of BSF 

Address of the BSF 

Service identifiers 

B-TID 

NAF_ID 

GBA U awareness of the NAF 



The content of Vendor-Specific- Application-ID according [1] is: 

<Vendor-Specif ic-Application-Id> : : =<AVP header: 260> 
1* [Vendor-Id] 
0*1 {Auth-Application-Id} 
0*1 {Acct-Application-Id} 



3GPP is 10415 

16777220 

Omitted 



The Destination-Realm AVP is set to subscriber"s BSF. The address of the BSF is extracted from the B-TID. 
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NOTE: In the case where the subscriber has contacted a NAF that is in a visited network, the NAF contacts the 

subscriber's home BSF through a Diameter based Proxy (Zn-Proxy) that is located in the same network as 
the NAF. The local BSF and the Zn-Proxy may be co-located. See 3GPP TS 33.220 [6]. 

The NAF indicates the GAA services for which the information is retrieved by GAA-Service-Identifier AVPs. 
The Bootstrapping Transaction Identifier defines the earlier bootstrapping procedure execution. 



Step 2 



In the successful case the BSF has a tuple < B-TID JMPTKs, Key lifetime, Bootstrapinfo creation time, GBA- 
UserSecSettings> identified by Bootstrapping Transaction Identifier (B-TID). When the BSF receives the 
request it checks the existence and validity of the tuple for given B-TID. If checking fails the BSF sends an 
Answer message with Experimental-Result set to indicate the error type 5403. If the tuple for B-TID exists, but 
is expired, error type 5403 is also send to indicate needs for renewal of the boostrapping procedure. In successful 
case the Result-Code is set to 2xxx as defined in [1]. 

The BSF derives the key material for the ME (i.e., Ks_NAF in the case of GBA_ME, and Ks_ext_NAF in the 
case of GBA_U) and possibly the key material for the UICC (i.e., Ks_int_NAF in the case of GBA_U) 
according to the B-TID and packs them into ME-Key-Material AVP and possible UICC-Key-Material AVP. The 
ME-Key-Material contains Ks_(ext)_NAF and the UICC-key-Material contains the Ks_int_NAF key. The BSF 
select correct user"s Security Settings according the request" s GAA-Service-Identifier AVP to GBA- 
UserSecSettings AVP. If NAF grouping is used by the operator and there are one or more USSs corresponding to 
the requested GSID, then also the nafGroup attribute of USS is checked. If the NAF has sent a GAA-Service- 
Identifier that does not have corresponding user"s security settings, and the BSF is locally configured to reject 
those requests from the NAF, then the error 5402 is raised. If the NAF has sent a GAA-Service-Identifier that 
have corresponding user's security settings, but the BSF is locally configured to reject those from that NAF, then 
the error 5402 is raised too. 

The NAF may be addressed from the UE with different FQDNs. The BSF shall check if this NAF-Id is allowed 
to be used for the NAF. If the NAF identified by its Origin-Host AVP is configured in the BSF not to be 
authorized to use the given NAF-Id, the BSF may raise the error situation 5402. The BSF may also be configured 
so that a certain NAF is not authorized to use a certain GAA-Service-Identifier. This situation may be also 
indicated by error code 5402. 



Step 3 



Address of BSF 

Realm of BSF 

IMPI 

Required 

Conditional 

Time of expiry 

Bootstrapinfo creation time 

Selected USSs 

GBA type used in bootstrapping 



After that the BSF shall send a Bootstrapping-Info- Answer message (BIA) back to the NAF. 

< Boostrapping-Inf o-Answer> ::= < Diameter Header: 310, PXY, 16777220 > 
< Session-Id > 
{ Vendor-Specif ic-Application-Id } 

[ Result-Code ] 

[ Experimental-Result] 
{ Origin-Host } 
{ Origin-Realm } 

[ User-Name ] 

[ ME-Key-Material ] 

[ UICC-Key-Material ] 

[ Key-ExpiryTime ] 

[ Bootstrapinf oCreationTime ] 

[ GBA-UserSecSettings ] 

[ GBA- Type ] 

* [ AVP ] 

* [ Proxy- Info ] 

* [ Route-Record ] 

The BSF may or may not send the User-name AVP (IMPI) according its configuration. 

The mandatory common key material with the ME (Ks_NAF or Ks_ext_NAF) is sent in the ME-Key-Material 
AVP. The common key material with the UICC (Ks_int_NAF) is optionally sent in the UICC-Key-Material 
AVP only if the "uiccType" tag in bsflnfo from the HSS is set to "GBA_U". 

The Key-ExpiryTime AVP contains the expiry time of the Bootstrapping information in the BSF according its 
configuration. The expiry time is represented according the Diameter Time data format in seconds that have 
passed since Oh on January 1, 1900 UTC . If a special key lifetime value is given in the "lifeTime" tag inside the 
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bsflnfo from the HSS in bootstraping procedure, it is used instead of the BSF default configuration value when 
the expiry time is calculated. 

The BootstrapInfoCreationTime AVP contains the bootstrapinfo creation time, i.e., creation time of the 
Bootstrapping information in the BSF. The bootstrapinfo creation time is represented in seconds that have passed 
since January 1, 1900 00:00:00.000 UTC. 

The BSF selects the appropriate User Security Settings (if any) to the GBA-UserSecSettings AVP from stored 
GAA-UserSecSettings in Bootstrapping information according the GBA-Service-Identifier AVPs in the request 
message. 

The BSF shall indicate the type of used authentication in the bootstrapping procedure to the NAF in GB A-Type, 
if other than 3G GB A type has been performed. 

When the NAF receives the BIA message, the NAF shall check the value of the GB A-Type AVP if it is included in the 
message. If the NAF does not support the GB A-Type the NAF shall stop processing the message and should indicate an 
error via the O&M subsystem. The further procedure in the NAF when the BIA is received is described in 3GPP TS 
33.220 [5], 3GPP TS 33.222 [11] and optionally in GAA service type specific TSs. 



5.3 



Protocol Zn between NAF and BSF based on Web Services 



The procedures in the NAF and in the BSF related Web Services [13] based Zn interface are the same as specified in 
clause 5.2, but instead of Diameter messages a Web Services procedures shall be used to communicate over Zn 
interface. Annex D specifies the GBA Service for Web Services, i.e., it contains the Web Services Definition Language 
(WSDL) [14] specification for GBA Service. Below are the attributes that are defined for GBA Service request, 
response, and fault cases. 



UE 




UE l<nows: 
<B-TID.Ks> 



Ua 



NAF 



Zn 



BSF 



{ a security association 
created by bootstrapping } 



BSF has tuple: 
< B-TID ./MP/.Ks. 
ME-Ks, UICC-Ks,GUSS> 



UE start the GAA application procedure 
by sending a B-TID. 



1. requestBootstrappinglnfo 

( b-tid, nafid, gsid*, 

gbaUAware, extension ) 



2. BSF checks the B-TID 

and derives 
ME-Key and UlCC-Key 



3. requestBootstrappinglnfoResponse 

( impi, meKey Material, 

uiccKeyMaterial, keyExpiryTime, 

bootstrappinglnfoCreatiotiTime, 

gbaType, ussList, extension ) 



UE and NAF mutually authenticate 
each others using ME-Ks 



Figure 5.4: The Web Services based GAA application procedure 

The possible attribute value definitions and restrictions for the request, response, and fault messages are the same as in 
clause 6 unless explicitly specified in this clause. The steps of the GAA application procedure in Figure 5.4 are: 

Step 1 
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The NAF shall send a requestBootstrappinglnfo message to the BSF. The schema of the message content is 
given here and it shall be in the same format as it is in WSDL. 

<xsd: element name="requestBootstrappingInf oRequest" > 
<xsd: complexType> 
<xsd : sequence> 

<xsd: element name="btid" type="xsd: string" /> 
<xsd:element name="nafid" type="xsd:base64Binary"/> 

<xsd:element name="gsid" type="xsd: string" minOccurs="0" maxOccurs="unbounded"/> 
<xsd:element name="gbaUAware" type="xsd:boolean" minOccurs=" 0"/> 
<xsd:element name=" extension" type=" typens : tExtension" minOccurs=" 0"/> 
</xsd : sequence> 
</xsd : complexType> 
</xsd : element> 

The SOAP message that shall be sent to BSF, i.e., the URI of the message shall contain the BSF address 
extracted from the B-TID. 

In the case where the subscriber has contacted a NAF that is in a visited network, the NAF contacts the 
subscriber's home BSF through a GBA-Proxy that is located in the same network as the NAF. The local BSF and 
the GBA-Proxy may be co-located. See 3GPP TS 33.220 [6]. 

The NAF indicates the GAA services for which the information is retrieved by "gsid" elements. The "btid" 
element defines the earlier bootstrapping procedure execution. The "gbaU Aware" element indicates whether 
NAF is GBA_U aware, and is capable of using and handling the "uiccKeyMaterial". The default value for 
"gbaU Aware" is false. The NAF may use one or more "extension" elements to include additional data to the 
request, but the BSF may ignore the additional data. 



Step 2 



The procedures for step 2 are the same as in step 2 in clause 5.2. 



Step 3 



After that requestBootstrappinglnfoResponse back to the NAF. 

<xsd: element name="requestBootstrappingInf oResponse" > 
<xsd : complexType> 
<xsd : sequence> 

<xsd: element name="impi" type="xsd: string" minOccurs=" 0"/> 
<xsd: element name="meKeyMaterial" type="xsd:base64Binary"/> 

<xsd:element name="uiccKeyMaterial" type="xsd:base64Binary" minOccurs=" 0"/> 
<xsd:element name="keyExpiryTime" type="xsd:dateTime"/> 

<xsd: element name="bootstrappingInfoCreationTime" type="xsd:dateTime"/> 
<xsd:element name="gbaType" type="xsd: string" minOccurs="0"/> 
<xsd:element name="ussList" type="xsd: string" minOccurs="0"/> 
<xsd:element name=" extension" type=" typens : tExtension" minOccurs=" 0"/> 
</xsd : sequence> 
</xsd : complexType> 
</xsd : element> 

The BSF may or may not send the "impi" element according its configuration. 

The mandatory common key material with the ME (Ks_NAF or Ks_ext_NAF) is sent in the "meKeyMaterial" 
element. The common key material with the UICC (Ks_int_NAF) is optionally sent in the "uiccKeyMaterial" 
element only if the "uiccType" tag in bsflnfo from the HSS is set to "GBA_U". 

The "keyExpiryTime" element contains the expiry time of the Bootstrapping information in the BSF according 
its configuration. If a special key lifetime value is given in the "lifeTime" tag inside the bsflnfo from the HSS in 
bootstraping procedure, it shall be used instead of the BSF default configuration value when the expiry time is 
calculated. 

The "bootstrappinglnfoCreationTime" element shall contain the bootstrapinfo creation time, i.e., creation time of 
the Bootstrapping information in the BSF. 

The BSF shall select the appropriate User Security Settings (if any) into the "ussList" element from stored GAA- 
UserSecSettings in Bootstrapping information according "gsid" elements in the request message. The "ussList" 
element contains a standalone XML document containing the User Security Settings as specified in Annex A. 
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The BSF shall indicate the type of used authentication in the bootstrapping procedure to the NAF in "gbaType" 
element, if other than 3G GB A type has been performed. 

The BSF may use one or more "extension" elements to include additional data to the request, but the NAF may 
ignore the additional data. 

When the NAF receives the requestBootstrappinglnfoResponse message, the NAF shall check the value of the 
"gbaType" element if it is included in the message. If the NAF does not support the GB A type the NAF shall stop 
processing the message and should indicate an error via the O&M subsystem. The further procedure in the NAF when 
the requestBootstrappinglnfoResponse message is received is described in 3GPP TS 33.220 [5], 3GPP TS 33.222 [11] 
and optionally in GAA service type specific TSs. 



6 Diameter application for Zh and Zn interfaces 

6.0 introduction 

The Zh and Zn interface protocols are defined as IETF vendor specific Diameter applications, where the vendor is 
3GPP. The vendor identifier assigned by lANA to 3GPP (http://www.iana.org/assignments/enterprise-numbers) is 
I04I5. 

The Diameter application identifier assigned to the Zh interface application is 16777221 (allocated by lANA). 

The Diameter application identifier assigned to the Zn interface application is 16777220 (allocated by I AN A). 

6.1 Command-Code values 

The Zn interface assigns new Command-Code 310. 

The messages in Zh interface use the same Command-Code value 303 as Multimedia- Auth-Request/ Answer messages 
defined in 3GPP TS 29.229 [3] for Cx interface. 

6.2 Result-Code AVP values 

This section defines new result code values that must be supported by all Diameter implementations that conform to this 
specification. When one of the result codes defined here is included in a response, it shall be inside an Experimental- 
Result AVP and Result-Code AVP shall be absent. 

6.2.1 Success 

Errors that fall within the Success category are used to inform a peer that a request has been successfully completed. 

The success category result codes defined in 3GPP TS 29.229 [3] for Cx interface are useless and therefore not required 
in Zh and Zn interfaces. 

6.2.2 Permanent failures 

Errors that fall within the Permanent Failures category are used to inform the peer that the request failed, and should not 
be attempted again. 

The Permanent failure category result codes defined in 3GPP TS 29.229 [3] for Cx interface are useless and therefore 
not required in Zh and Zn interfaces. 

6.2.2.1 DIAMETER_ERRORJMPI_UNKNOWN (5401) 

A message was received by the HSS for an IMPI that is unknown. 
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6.2.2.2 



DIAMETER_ERROR_NOT_AUTHORIZED(5402) 



A message was received by the BSF which the BSF can not authorize. In this case the NAF should indicate to the UE 
that the service is not allowed. 



6.2.2.3 



DIAMETER_ERROR_TRANSACTIONJDENTIFIERJNVALID(5403) 



A message was received by the BSF for an invalid (e.g. unknown or expired) Bootstrapping Transaction Identifier (B- 
TID). In this case the NAF should request the UE to bootstrap again. 



6.2.2.4 



Void 



6.2.2.5 



Void 



6.2.2.6 



Void 



6.2.2.7 



Void 



6.3 



AVPs 



The AVPs defined in 3GPP TS 29.229 [3] for 3GPP IMS Cx interface Multimedia-Auth-Request/ Answer messages are 
used as they are. 

The following table describes the additional new Diameter AVPs defined for the Zh and Zn interface protocol, their 
AVP Code values, types, possible flag values and whether or not the AVP may be encrypted. The Vendor-Id header of 
all AVPs defined in this specification shall be set to 3GPP (10415). 

Table 6.1 : New Diameter Multimedia Application AVPs 











AVP Flag rules 




Attribute Name 


AVP 

Code 


Section 
defined 


Value Type 


Must 


May 


Should 
not 


Must 
not 


May 
Encr. 


GBA-UserSecSettings 


400 


6.3.1.1 


OctedString 


M, V 








No 


Transaction-Identifier 


401 


6.3.1.2 


OctetString 


M, V 








No 


NAF-Id 


402 


6.3.1.3 


OctetString 


M, V 








No 


GAA-Service-Identifier 


403 


6.3.1.4 


OctedString 


M, V 








No 


Key-ExpiryTime 


404 


6.3.1.5 


Time 


M,V 








No 


ME-Key-Material 


405 


6.3.1.6 


OctedString 


M, V 








No 


UICC-Key-Material 


406 


6.3.1.7 


OctedString 


M, V 








No 


GBA_U-Awareness-Indicator 


407 


6.3.1.8 


Enumerated 


M, V 








No 


BootstrapInfoCreationTime 


408 


6.3.1.9 


Time 


M,V 








No 


GUSS-Timestamp 


409 


6.3.1.10 


Time 


V 






M 


No 


GBA-Type 


410 


6.3.1.11 


Enumerated 


M, V 








No 


NOTE 1 : The AVP header bit denoted as "M", indicates whether support of the AVP is required. The AVP header 
bit denoted as "V", indicates whether the optional Vendor-ID field is present in the AVP header. 
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6.3.1 Common AVPs 

6.3.1.1 GBA-UserSecSettings AVP 

The GAA-UserSecSettings AVP (AVP code 400) is of type OctetString. If transmitted on the Zh interface it contains 
GBA user security settings (GUSS). If transmitted on the Zn interface it contains the relevant USSs only. The content of 
GBA-UserSecSettings AVP is a XML document which is defined in annex A. 

6.3.1 .2 Transaction-Identifier AVP 

The Transaction-Identifier AVP (AVP code 401) is of type OctetString. This AVP contains the Bootstrapping 
Transaction Identifier (B-TID). 

6.3.1.3 NAF-ld 

The NAF-Id AVP (AVP code 402) is of type OctetString. This AVP contains the full qualified domain name (FQDN) 
of the NAF that the UE uses concatenated with the Ua security protocol identifier as specified in TS 33.220 [5]. The 
FQDN of the NAF that is part of the NAF_Id may be a different domain name that with which the BSF knows the NAF. 

6.3.1 .4 GAA-Service-ldentifier AVP 

The GAA-Service-identifier AVP (AVP code 403) is of type OctedString. This AVP informs a BSF about the support 
of a GAA-service by the NAF. According this AVP the BSF can select the right service"s user security settings. 

For 3GPP standardized services (e.g., PKI portal), the GAA-Service-Identifier (GSID) shall be in the range to 999999, 
and the currently standardized values for GSID shall be the GAA Service Type Code of the particular service. The 
GAA Service Type Codes for 3GPP standardized services are defined in Annex B. 

NOTE: In the future, standardized GSID values that are different than the GAA Service Type Code may be 

standardised (e.g. to differentiate between the services "MBMS streaming" and "MBMS download") and 
then several different GSID can exist within one GAA Service Type Code. 

Examples: The GSID is " 1 " for all PKI-portals, and "4" for all MBMS services. 

6.3.1 .5 Key-ExpiryTime AVP 

The Key-ExpiryTime AVP (AVP code 404) is of type Time. This AVP informs the NAF about the expiry time of the 
key. 

6.3.1 .6 ME-Key-Material AVP 

The required ME-Key-Material AVP (AVP code 405) is of type OctetString. The NAF is sharing this key material 
(Ks_NAF in the case of GBA_ME or Ks_ext_NAF in the case of GBA_U) with the Mobile Equipment (ME). 

6.3.1 .7 UlCC-Key-Material AVP 

The condition UICC-Key-Material AVP (AVP code 406) is of type OctetString. The NAF may share this key material 
(Ks_int_NAF in the case of GBA_U) with a security element (e.g. USIM, ISIM, etc..) in the UICC. Only some GAA 
applications use this conditional AVP. 

6.3.1 .8 GBA_U-Awareness-lndicator 

The conditional GBA_U- Awareness-Indicator AVP (AVP code 407) is of type Enumerated. The following values are 
defined. 

NO (0) The sending node is not GBA_U aware 

YES(l) The sending node is GBA_U aware 

The default value is i.e. absence of this AVP indicates that the sending node is not GBA_U aware. 
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6.3.1 .9 BootstraplnfoCreationTime AVP 

The BootstraplnfoCreationTime AVP (AVP code 408) is of type Time. This AVP informs the NAF about the 
bootstrapinfo cration time of the key. 

6.3.1.10 GUSS-Timestamp AVP 

The GUSS-Timestamp AVP (AVP code 409) is of type Time. If transmitted this AVP informs the HSS about the 
timestamp of the GUSS stored in the BSF. 

6.3.1.11 GBA-Type 

The GBA-Type AVP (AVP code 410) is of type Enumerated. The AVP informs the NAF about the authentication type 
that was used during bootstrapping procedure. 

The following values are defined: 

• 3GGBA(0) The 3GGBA has been performed as defined in TS 33.220 [5]. 

• 2GGBA(1) The 2GGBA has been performed as defined in TS 33.220 [5]. 
The default value is i.e. the absence of this AVP indicates 3G GBA 



6.4 User identity to HSS resolution 



The User identity to HSS resolution mechanism enables the BSF to find the address of the HSS that holds the subscriber 
data for a given subscriber when multiple and separately addressable HSSs have been deployed by the network 
operator. The resolution mechanism is not required in networks that utilise a single HSS or when an BSF is configured 
to use pre-defined HSS. 

The resolution mechanism is based on the Subscription Locator Function (SLF) and is equivalent to that described for 
the Cx/Dx interface described in 3GPP TS 23.228 [12]. The BSF accesses the subscription locator via the Dz interface. 
The Dz interface is always used in conjunction with the Zh interface. The Dz interface is based on Diameter. Its 
functionality is implemented by means of the routing mechanism provided by an enhanced Diameter redirect agent, 
which is able to extract the Subscriber identity from the received requests. 

To get the HSS address the BSF sends to the SLF the Zh requests aimed for the HSS. On receipt of the HSS address 
from the SLF, the BSF shall send the Zh requests to the HSS. The BSF may store the HSS address and use it in further 
requests associated to the same Subscriber. 

In networks where the use of the user identity to HSS resolution mechanism is required and the BSF is not configured to 
use predefined HSS, each BSF shall be configured with the address/name of the SLF implementing this resolution 
mechanism. 
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7 Use of namespaces 



This clause contains the namespaces that have either been created in this 3GPP specification, or in 3GPP specification 
3GPP TS 29.229 [3] or the values assigned to existing namespaces managed by lANA. 

7.1 AVP codes 

This specification reserves the 3GPP vendor specific values 10415:400-499 and assigns values 10415:400-410 for the 
GAA from the 3GPP AVP Code namespace for 3GPP Diameter applications ([8]). The 3GPP vendor specific AVP 
code space is managed by 3GPP CT4. See section 6 for the assignment of the namespace in this specification. 

Besides the Diameter Base Protocol AVPs [1] this specification reuses the following AVPs from 3GPP TS 29.229 [3]: 
Authentication-Session-State, User-Name and SIP-Auth-Data-Item. 

7.2 Experimental-Result-Code AVP values 

This specification reserves Experimental-Result-Code AVP values 10415:2401-2409 and 10415:5401-5409. See section 
6.2. 

7.3 Command Code values 

Only Command-Codes 310 and 303 from 3GPP TS 29.229 [3] is used in this specification. 

This specification reuses only the Command-Code value, not the content of the original specification. The AVPs, that are 
defined required in TS 29.229 [3], but are not needed in Zh or Zn interfaces, are removed and are therefore not required in 
Zh or Zn interface messages. All new AVPs for GAA are defined optional although they may be mandatory in GAA 
viewpoint. 

This specification does not assign new command codes to the 3GPP TS 29.229 [3]. 
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Annex A (normative): 
GBA-UserSecSettings XML definition 

This annex contains the XML schema definition for an XML document carrying the GBA User Security Settings inside 
GBA-UserSecSettings AVP in Zh and Zn interface. 

<?xml version="l. 0" encoding="UTF-8 " ?> 

<xs : schema targetNamespace="urn: 3gpp :gba :GBAGUSS Schema -R7 : 2007-05" 
xmlns : tns= "urn : 3gpp : gba : GBAGUSSSchema-R7 : 2007 - 05 " 
xmlns:xs="http: //www.w3 . org/2 1/XMLSchema" 
elementFormDefault= "qualified" 
attributeFormDef ault= "unqualified" > 

<!-- This import brings in the XML language attribute xml:lang--> 
<xs : import namespace="http : //www. w3 . org/XML/ 1998 /namespace" 
schemaLocation="http : //www. w3 . org/2 01/xml .xsd"/> 

<xs : complexType name="ExtensionType" > 

<xs : sequence> 

<xs : any processContents="lax" minOccurs="0 " maxOccurs= "unbounded" /> 

</xs : sequence> 
</xs : complexType > 

<xs : complexType name="GUSSExtensionType" > 
<xs : sequence> 

<xs:element name="timestamp" type="xs : dateTime" minOccurs="0 "/> 
<xs:element name= "Extension" type="tns : ExtensionType" minOccurs="0 "/> 
</xs : sequence> 
</xs : complexType > 

<xs : complexType name="USSExtensionType" > 
<xs : sequence> 

<xs:element name="k;eyChoice" type="xs : string" minOccurs="0 " /> 
<xs:element name= "Extension" type="tns : ExtensionType" minOccurs="0 "/> 
</xs : sequence> 
</xs : complexType > 

<!-- The whole user"s GBA specific data set --> 
<xs : complexType name="guss"> 
<xs : sequence> 

<xs:element name="bsf Inf o" type="tns :bsf Inf oType" minOccurs="0 "/> 
<xs: element name="ussList " type="tns :ussListType"/> 

<xs:element name= "Extension" type="tns :GUSSExtensionType" minOccurs="0 "/> 
<xs:any namespace="##other" processContents="lax" minOccurs="0 " 
maxOccurs= "unbounded" / > 
</xs : sequence> 

<xs : attribute name="id" type="xs : string"/> 
</xs : complexType> 

<!-- BSF specific information element --> 
<xs : complexType name="bsf Inf oType" > 
<xs : sequence> 

<xs:element name="uiccType" type="xs : string" minOccurs="0 " /> 
<xs:element name="lif eTime" type="xs : integer" minOccurs="0 " /> 
<xs:element name= "Extension" type="tns : ExtensionType" minOccurs="0 "/> 
<xs:any namespace="##other" processContents="lax" minOccurs="0 " 
maxOccurs= "unbounded" / > 
</xs : sequence> 
</xs : complexType > 
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<!--List of all users individual User Security Settings --> 
<xs : complexType name="ussListType" > 

<xs : sequence TninOccurs="0 " maxOccurs= "unbounded" > 
<xs: element naTne="uss" type="tns :ussType"/> 

<xs:eleTnent name= "Extension" type="tns : ExtensionType" ininOccurs="0 "/> 
<xs:any namespace= "##other " processContents="lax" TninOccurs="0 " 
TnaxOccurs= "unbounded" / > 
</xs : sequence> 
</xs : complexType > 

<!-- User Security Setting data --> 
<xs : complexType name="ussType" > 
<xs : sequence> 

<xs: element name="uids" type="tns :uidsType"/> 
<xs: element name=" flags" type="tns : f lagsType"/> 

<xs:element name= "Extension" type="tns :USSExtensionType" minOccurs="0 "/> 
<xs:any namespace="##other" processContents="lax" minOccurs="0 " 
maxOccurs= "unbounded" / > 
</xs : sequence> 

<xs : attribute name="id" use="required" type="xs : string"/> 
<xs : attribute name="type" use=" required" type="xs : int "/> 
<xs : attribute name="naf Group" use= "optional" type="xs : string"/> 
</xs : complexType > 

<!-- User Public Identities for authentication --> 
<xs : complexType name="uidsType" > 

<xs: sequence minOccurs="l" maxOccurs= "unbounded" > 
<xs:element name="uid" type="xs : string"/> 

<xs:element name= "Extension" type="tns : ExtensionType" minOccurs="0 "/> 
<xs:any namespace="##other" processContents="lax" minOccurs="0 " 
maxOccurs= "unbounded" / > 
</xs : sequence> 
</xs : complexType > 

<!-- GAA Application type specific Authorization flag codes --> 
<xs : complexType name="f lagsType" > 

<xs : sequence minOccurs="0 " maxOccurs= "unbounded" > 
<xs:element name="flag" type="xs : int "/> 

<xs:element name= "Extension" type="tns : ExtensionType" minOccurs="0 "/> 
<xs:any namespace= "##other " processContents="lax" minOccurs="0 " 
maxOccurs= "unbounded" / > 
</xs : sequence> 
</xs : complexType > 

</xs : schema> 

NOTE 1: The <xs:any> elements within the complex types ExtensionType allow for compatible standard 

extensions in future releases. The <xs:any namespace=##other"> elements within the other complex types 
allow for compatible private extensions. 



The values are: 



The value of the attribute "id" in the element "guss" is the same as user"s IM Private Identity (IMPI) used 
in User-Name AVP. 

The value of the element "timestamp" in the element "guss" is the same type as GUSS-Timstamp used in 
GUSS-Timestamp AVP and indicates the timestamp of the GUSS. Timestamp value shall be expressed in 
UTC form, indicated by a time zone designator "Z" immediately following the time portion of the value. 

The value of the attribute "id" in the element "uss" is the same as service identifier (GSID) used in GAA- 
Service-Identifier AVP. 
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NOTE 2: In the case with currently standardized 3GPP applications (c. f. Annex B), the service identifier (GSID) is 
the same as the GAA Service Type Code i.e. the "id" and the "type" attribute would have the same value. 
For example, in the interoperator GAA where the requesting BM-SC (i.e. NAP) is different operator 
network than the answering BSF, the BM-SC (NAP) can request particular user's MBMS USS by using 
"4" for the GSID in the "id" attribute in the USS. If the BSP operator wishes to have different MBMS 
USSs for different BM-SCs (NAPs), it can use the nafGroup attribute to separate NAPs to specific 
groups, and each group would get a particular USSs: <uss id="4" type="4" nafGroup="A"> would be 
given to NAPs in group A, and <uss id="4" type="4" nafGroup="B"> would be given to NAPs in group 
B when they request it. NAP groups are operator specific, i.e., operator decides which USS is given to 
which NAP." 

• The value of the element "uiccType" in the element "bsflnfo" is: 
GBA to indicate the basic case, or 

GBA_U to indicate that generation of Ks_int_NAP is also required in the BSP. 
The default value is GBA. 

• The value of the element "lifeTime" in the element "bsflnfo" indicates a user specific key lifetime (duration 
in seconds). If the lifeTime element is missing the default value in the BSP is used. 

• The value of attribute "type" in the element "uss" is GAA service type code defined in annex B. 

• The value of attribute "nafGroup" in the element "uss" is an operator internal group designator for a NAP 
group the USS is valid for. If this attribute is missing then only the attribute "id" is used for selection of this 
element. 

• Values of the element "uid" are user"s public authentication identities from the HSS. 

• Values of element "flag" are user"s authorization flag codes from the HSS for GAA service type indicated 
in the type attribute in the parent uss element. If an authorization flag exist the NAP have permission to 
give the corresponding service, otherwise not 

• The value of the element "keyChoice" in the element "uss" is "ME-based-key", i.e., Ks_ NAP or 
Ks_ext_NAP shall be used, or "UICC -based-key", i.e., Ks_int_NAP shall be used or " ME-UICC -based- 
keys", i.e., Ks_ext_NAP or Ks_int_NAP can be used. The value of this attribute indicates to the NAP, 
which key shall be used. If the keyChoice attribute is missing, then as a default the "ME-based-key" shall 
be used by the NAP. 

In the following illustrative example the values are italised and underlined. The content of one User Security Setting 
tag is boxed. 

<guss id= " 3 5850000483 6551@ims . mncOBO . mcc358 . 3ctppnetwork . org " > 
<bsf Inf o> 

<lifeTiTne>86400</lifeTime> 
</bsf Info> 
<ussList> 



<uss 


id="l" type="l"> 
<uids> 

<u±d>tel:358504836551</uid> 








<uid>lauri . laitinen@nokia . com< 


/ui 


d> 




</uids> 








<f lags> 








<flag>l</flag> 








</f lags> 






</uss> 







</ussList> 
</guss> 

The above GAA User Security Settings example for user "358500004836551 @ ims.mnc050.mcc358.3gppnetwork.org" 
defines that for PKI-Portal (GAA service type code is 1) services are allowed for user identities "tel:35850483655r' 
and "lauri.laitinen@nokia.com" and authentication is allowed (flag 1 exists) but non-repudiation is not allowed (flag 2 
is missing) to NAPs that provide the GAA service identified by "1" GAA Service Identifier. The BSP shall not generate 
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UICC-Ks, because uiccType is missing. A special key lifetime defines that a the duration after which the key expires is 
86400 seconds 
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Annex B (normative): GAA Service Type Codes 

The GAA Service Type Code values are used in GAA to indicate interpretation, coding and usage of GAA service type 
specific data. 

For examples each GAA service type may have their own set of authorization flags. Meaning and coding of these flags 
are defined in Annex C. There may also be proprietary GAA service types with their own definitions in the future. 

Code values - 999999 are reserved for standardized GAA service types. 

The following values are defined for standardized GAA service types with 3GPP specification: 

Unspecific service 

1 PKI-Portal 

2 Authentication Proxy 

3 Presence 

4 MBMS 

5 Liberty Alliance Project (see [15]) 

6 UICC - Terminal Key Establishment (see [17]) 

7 Terminal - Remote Device Key Establishment (see [18]) 

Default value is 0. An unspecific service may or may not have user security settings containing or not a list of public 
identities. An unspecific service cannot have specified authorization flags or other service type specific data. 
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Annex C (normative): GAA Authorization flag codes 

For GAA services which have a defined set of special authorization flag codes the following rule holds: The service 
specified by the GAA authorization flag codes is allowed for a user only if user"s user security setting contains that 
flag. 

The following standardised GAA service types that are listed in previous annex B have the following special 
authorization flag codes: 

PKI-Portal (1) 

1 Authentication allowed 

2 Non-repudiation allowed 
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Annex D (normative): 

Web Services Definition for Zn interface 

This annex contains the Web Services Defination Language (WSDL) [14] for Zn interface: 



<?xml version="l . 0" encoding="UTF-8" ?> 

<wsdl : definitions name="GBAService" 

t argetName space =" urn: 3gpp :gba iGBAService : 2007- 05" 

xmlns : typens="urn: 3gpp :gba iGBAService : 2007- 05" 

xmlns :wsdl="http : //schemas .xmlsoap . org/wsdl/" 

xmlns : soap="http : //schemas .xmlsoap .org/wsdl /soap/" 

xmlns :xsd="http: //www.w3 . org/2 01/XMLSchema" 

xmlns : soapenc="http : //schemas .xmlsoap .org/ soap/ encoding/" > 

<wsdl : types> 

<xsd: schema targetNamespace="urn: 3gpp :gba iGBAService : 2007-05" > 

<!-- Extension element definition --> 
<xsd: complexType name="tExtension" > 

<xsd : sequence> 

<xsd:any processContents="lax" minOccurs="0" maxOccurs=" unbounded" /> 

</xsd : sequence> 
</xsd : complexType> 

<!-- Request Bootstrapping info request parameter definitions --> 
<xsd: element name="requestBootstrappingInf oRequest" > 
<xsd : complexType> 
<xsd : sequence> 

<xsd:element name="btid" type="xsd: string" /> 
<xsd:element name="nafid" type="xsd:base64Binary"/> 

<xsd:element name="gsid" type="xsd: string" minOccurs=" 0" maxOccurs="unbounded"/> 
<xsd:element name="gbaUAware" type="xsd: boolean" minOccurs="0"/> 
<xsd:element name=" extension" type="typens : tExtension" minOccurs=" 0"/> 
</xsd : sequence> 
</xsd : complexType> 
</xsd: element > 

<!-- Request Bootstrapping info responset parameter definitions --> 
<xsd: element name="requestBootstrappingInfoResponse" > 
<xsd: complexType > 
<xsd : sequence> 

<xsd:element name="impi" type="xsd: string" minOccurs=" 0"/> 
<xsd: element name="meKeyMaterial" type="xsd:base64Binary"/> 

<xsd:element name="uiccKeyMaterial" type="xsd:base64Binary" minOccurs=" 0"/> 
<xsd:element name="keyExpiryTime" type="xsd:dateTime"/> 

<xsd: element name="bootstrappingInfoCreationTime" type="xsd:dateTime"/> 
<xsd:element name="gbaType" type="xsd: string" minOccurs="0"/> 
<xsd:element name="ussList" type="xsd: string" minOccurs="0"/> 
<xsd:element name=" extension" type="typens : tExtension" minOccurs="0"/> 
</xsd : sequence> 
</xsd : complexType> 
</xsd : element> 

<!-- Request Bootstrapping info fault parameter definitions --> 
<xsd: element name="requestBootstrappingInfoFault" > 
<xsd : complexType> 
<xsd : sequence> 

<xsd:element name="errorCode" type="xsd: integer"/> 
<xsd:element name="errorText" type="xsd: string" minOccurs="0"/> 
</xsd : sequence> 
</xsd : complexType> 
</xsd : element> 

</xsd: schema> 

</wsdl : types> 

<wsdl : message name="requestBootstrappingInf oRequestMessage" > 

<wsdl :part name="body" element="typens : requestBootstrappingInf oRequest "/> 

</wsdl :message> 

<wsdl imessage name="requestBootstrappingInfoResponseMessage" > 

<wsdl :part name =" body" element="typens : requestBootstrappingInfoResponse"/> 
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</wsdl :message> 

<wsdl : message name="requestBootstrappingInf oFaultMessage" > 

<wsdl :part name =" body" element="typens : requestBootstrappingInf oFault"/> 
</wsdl :message> 

<wsdl iportType name="GBAServicePortType" > 

<wsdl : operation name="requestBootstrappingInfo" > 

<wsdl : input message=" typens : requestBootstrappingInf oRequestMessage"/> 
<wsdl : output message=" typens : requestBootstrappingInf oResponseMessage"/> 
<wsdl : fault name="FaultName" message=" typens : requestBootstrappingInfoFaultMessage"/> 
</wsdl : operation> 
</wsdl :portType> 

<wsdl : binding name="GBAServiceBinding" type=" typens iGBAServicePortType" > 

<soap : binding style=" document" transport ="http : //schemas .xmlsoap .org/soap/http"/> 
<wsdl : operation name="requestBootstrappingInfo" > 

<soap : operation soapAction="urn: 3gpp :gba iGBAServiceAction: 2007-05 "/> 
<wsdl : input > 

<soap:body use="literal"/> 
</wsdl : input > 
<wsdl : output> 

<soap:body use="literal"/> 
</wsdl : output> 
<wsdl : fault name="FaultName" > 

<soap:fault name="FaultName" use="literal"/> 
</wsdl : f ault> 
</wsdl : operation> 
</wsdl : binding> 

<wsdl : service name="GBAService" > 

<wsdl :port name="GBAServicePort" binding=" typens iGBAServiceBinding" > 
<!-- add SOAP address location URI below --> 

<soap : address location="http : //add. here .uri . to/GBAService"/> 
</wsdl :port> 
</wsdl : service> 

</wsdl :def initions> 
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Annex E (informative): 

Liberty authentication context definitions for GBA 

E.1 Introduction 

This clause describes the GBA Authentication Context definition that the Liberty Identity Provider uses to describe 
GBA parameters to Liberty Service Provider. The Liberty 3GPP Security Interworking is further discussed in 3GPP TR 
33.980 [15]. 



E.2 GBA Authentication context statement data model 

A particular Liberty authentication context statement will capture the characteristics of the process, procedures, and 
mechanisms by which the authentication authority verified the subject before issuing an identity, protects the secrets on 
which subsequent authentications are based, and the mechanisms used for this authentication. These characteristics are 
categorized in the Liberty ID-FF Authentication Context Specification [16] as follows: 

Identification - Characteristics that describe the processes and mechanism the authentication authority uses to 
initially create an association between a subject and the identity (or name) by which the subject will be known. 

Technical Protection - Characteristics that describe how the "secret" (the knowledge or possession of which 
allows the subject to authenticate to the authentication authority) is kept secure. 

Operational Protection - Characteristics that describe procedural security controls employed by the 
authentication authority (for example, security audits, records archival). 

Authentication Method - Characteristics that define the mechanisms by which the subject of the issued assertion 
authenticates to the authentication authority (for example, a password versus a smartcard). 

Governing Agreements - Characteristics that describe the legal framework (e.g. liability constraints and 
contractual obligations) underlying the authentication event and/or its associated technical authentication 
infrastructure. 

Compared to Liberty Authentication Context [16], the GBA Authentication Context statement data model adds a 
description to to which GBA mechanism was used during bootstrapping with the BSF, and how the corresponding 
shared secret was used with the Identity Provider (IdP) that functions as a NAP. 

The authentication contexts classes specific to mobile terminals specified by Liberty Alliance are called 

MobileOneFactorUnregistered, 

- MobileTwoFactorUnregistered, 

MobileOneFactorContract, and 

MobileTwoFactorContract classes. 

The GBA authentication context uses some of the elements in these classes and introduces a new element called 
"GBAMechanism", which can be used to describe GBA specific parameters of the authentication. The elements used in 
the GBA Authentication Context schemas are: 

GBAMechanismType: describes the GBA bootstrapping mechanism (identifies the method used over Ub 
reference point); 

AuthenticatorTransportProtocolType: describes the authentication mechanism that was used authenticate the UE 
towards the Liberty Identity Provider (identifies the method used over Ua reference point); 

KeyActivationType: describes the mechanism to achieve two factor authentication (valid in *TwoFactor* 
authentication schemas). 
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E.3 GBA authentication context statement schema 

This section lists the complete GBA Authentication Context XML schema. It is based on Liberty Authentication 
Context XML Schema to which the addition is the additional description of how GBA procedures have been conducted, 
i.e., GBAMechanism element. 



<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema t argetName space =" urn: 3gpp :gba :ac:2006-10" 
xmlns :xs="http: //www.w3 . org/2 1/XMLSchema" 
xmlns :ac="urn: liberty : ac : 2004-12 " 
xmlns =" urn: 3gpp :gba :ac:2006-10"> 

<!-- imports Liberty Authentication Context definitions --> 
<xs : import namespace="urn: liberty : ac : 2004-12" 

schemaLocation="liberty-authentication-context-v2 . .xsd"/> 

<xs : annotation> 

<xs : documentation> 

This authentication context has been defined for the 
3GPP and 3GPP2 Generic Bootstrapping Architecture. It 
defines new GBAMechanismType and its values, but reuses 
the Liberty authentication context schema for other 
values. The GBA authentication context is based on the 
MobileOneFactor* and MobileTwoFactor* authentication 
contexts with the exception that only shared secret 
based authentication methods {i.e., symmetric) are used, 
and private key {i.e., asymmetric) methods are not 
used when authenticating the UE due to the nature of GBA. 
</xs : documentation> 

</xs : annotation> 

<!-- new type definitions for different GBA procedures --> 
<xs: element name="LegacyGBA" > 
<xs : annotation> 

<xs : documentation> 

Legacy GBA where existing old authentication 
frameworks are used for bootstrapping such 
2G GBA in 3GPP, and CDMA Ix and CDMA IxEvDo 
in 3GPP2 . 
</xs : documentation> 
</xs : annotation> 
</xs : element> 

<xs : element name="GBAMobileMobile" > 
<xs : annotation> 

<xs : documentation> 

GBA using AKA as specified in 3GPP and 3GPP2 . 
The shared secret is derived in the mobile and 
used in the mobile. 
</xs : documentation> 
</xs : annotation> 
</xs : element> 

<xs : element name="GBAUICCMobile" > 
<xs : annotation> 

<xs : documentation> 

GBA_U using AKA as specified in 3GPP and 3GPP2 . 
The shared secret is derived in the UICC and used 
in the mobile. 
</xs : documentation> 
</xs : annotation> 
</xs : element> 

<xs: element name="GBAUICCUICC" > 
<xs : annotation> 

<xs : documentation> 

GBA_U using AKA as specified in 3GPP and 3GPP2 . 
The shared secret is derived in the UICC and used 
in the UICC. 
</xs : documentation> 
</xs : annotation> 
</xs : element> 

<xs: element name="GBAMechanism" type="GBAMechanismType" > 
<xs : annotation> 
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<xs : documentation> 

GBA mechanism used in the bootstrapping procedure. 
</xs : documentation> 
</xs : annotation> 
</xs : element> 

<xs : complexType name="GBAMechanismType" > 
<xs : choice> 

<xs:element ref ="LegacyGBA"/> 
<xs :element ref ="GBAMobileMobile"/> 
<xs relement ref = "GBAUICCMobile'7> 
<xs: element ref ="GBAUICCUICC"/> 
</xs : choice> 
</xs : complexType > 

</xs : schema> 



E.4 GBA authentication context classes 



E.4.1 GBAOneFactorUnregistered 



This class reflects that there were no mobile customer registration procedures and an authentication of the UE is done 
without requiring explict end-user interaction. 

E.4.1 .1 Associated 3GPP URI 

http://www.3gpp.org/schemas/authctx/classes/GBAOneFactorUnregistered 

E.4. 1.2 Class schema 



<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema t argetName space =" urn: 3gpp :gba :ac:2006-10" 
xmlns :xs="http: //www.w3 . org/2 1/XMLSchema" 
xmlns :ac="urn: liberty : ac : 2004-12 " 
xmlns="urn: 3gpp :gba :ac:2006-10" 
finalDefault=" extension" 
version="l . 0" > 

<!-- Imports Liberty authentication context schema definitions --> 
<xs : import name space= "urn: liberty: ac: 2004-12" 

schemaLocation="liberty-authentication-context-v2 . .xsd"/> 

<!-- includes 3GPP GBA Authentication Context generic definitions --> 
<xs : include schemaLocation="3gpp-gba-authentication-context-vl . .xsd"/> 

<!-- GBAOneFactorUnregistered --> 

<xs : complexType name="GBAOneFactorUnregisteredGBAMechanismType" > 
<xs : complexContent> 

<xs : restriction base="GBAMechanismType" > 
<xs : choice> 

<xs:element ref ="LegacyGBA"/> 
<xs :element ref ="GBAMobileMobile"/> 
<xs :element ref ="GBAUICCMobile"/> 
<xs: element ref ="GBAUICCUICC"/> 
</xs : choice> 
</xs : restriction> 
</xs : complexContent> 
</xs : complexType > 

<!-- states which protocol was used between UE and NAF/IdP to authenticate the UE - 
<xs : complexType name="GBAOneFactorUnregisteredAuthenticatorTransportProtocolType" > 
<xs : complexContent> 

<xs : restriction base="ac :AuthenticatorTransportProtocolType" > 
<xs : choice> 

<xs:element ref ="ac :HTTP"/> <!-- HTTP Digest over SSL/TLS --> 
<xs:element ref ="ac : SSL"/> <!-- PSK TLS --> 
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</xs : choice> 
</xs : restriction> 
</xs : complexContent> 
</xs : complexType> 

</xs : schema> 



E.4.2 GBATwo Factor Unregistered 



This class reflects that there were no mobile customer registration procedures and a two-factor based authentication of 
the UE is done requiring an explicit end-user interaction during authentication procedure (e.g., a PIN needs to be typed). 

E.4.2.1 Associated 3GPP URI 

http://www.3gpp.org/schemas/authctx/classes/GBATwoFactorUnregistered 



E.4.2. 2 Class scinema 



<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema targetNamespace="urn: 3gpp :gba :ac:2006-10" 
xmlns :xs="http: //www.w3 . org/2 1/XMLSchema" 
xmlns :ac="urn: liberty: ac : 2004-12" 
xmlns="urn: 3gpp :gba :ac:2006-10" 
finalDefault=" extension" 
version="l . 0" > 

<!-- Imports Liberty authentication context schema definitions --> 
<xs : import namespace="urn : liberty: ac: 2004-12" 

schemaLocation="liberty-authentication-context-v2 . .xsd"/> 

<!-- includes 3GPP GBA Authentication Context generic definitions --> 
<xs : include schemaLocation="3gpp-gba-authentication-context-vl . .xsd"/> 

<!-- GBATwoFactorUnregistered --> 

<xs : complexType name="GBATwoFactorUnregisteredGBAMechanismType" > 
<xs : complexContent> 

<xs : restriction base="GBAMechanismType" > 
<xs : choice> 

<xs:element ref ="LegacyGBA"/> 
<xs: element ref ="GBAMobileMobile"/> 
<xs: element ref ="GBAUICCMobile"/> 
<xs: element ref ="GBAUICCUICC"/> 
</xs : choice> 
</xs : restriction> 
</xs : complexContent> 
</xs : complexType > 

<!-- states which protocol was used between UE and NAF/IdP to authenticate the UE - 
<xs : complexType name="GBATwoFactorUnregisteredAuthenticatorTransportProtocolType" > 
<xs : complexContent> 

<xs : restriction base="ac :AuthenticatorTransportProtocolType" > 
<xs : choice> 

<xs:element ref ="ac : HTTP" /> <!-- HTTP Digest over SSL/TLS --> 
<xs:element ref ="ac : SSL"/> <!-- PSK TLS --> 
</xs : choice> 
</xs : restriction> 
</xs : complexContent> 
</xs : complexType> 

<xs : complexType name="GBATwoFactorUnregisteredKeyActivationType" > 
<xs : complexContent> 

<xs : restriction base="ac : KeyActivationType" > 
<xs : choice> 

<xs : element ref ="ac :ActivationPin"/> 

<xs:element ref ="ac : Extension" maxOccurs="unbounded"/> 
</xs : choice> 
</xs : restriction> 
</xs : complexContent> 
</xs : complexType> 
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</xs : schema> 



E.4.3 GBAOneFactorContract 

This class reflects that mobile customer registration procedures have taken place and an authentication of the UE is 
done without requiring explicit end-user interaction. 

E.4.3.1 Associated 3GPP URI 

http://www.3gpp.org/schemas/authctx/classes/GBAOneFactorContract 

E.4.3. 2 Class schema 



<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema targetNamespace="urn: 3gpp :gba :ac:2006-10" 
xmlns :xs="http: //www.w3 . org/2 1/XMLSchema" 
xmlns :ac="urn: liberty: ac :2004-12" 
xmlns="urn: 3gpp :gba :ac:2006-10" 
finalDefault=" extension" 
version="l . 0" > 

<!-- Imports Liberty authentication context schema definitions --> 
<xs : import namespace="urn : liberty: ac: 2004-12" 

schemaLocation="liberty-authentication-context-v2 . .xsd"/> 

<!-- includes 3GPP GBA Authentication Context generic definitions --> 
<xs : include schemaLocation="3gpp-gba-authentication-context-vl . .xsd"/> 

<!-- GBAOneFactorContract --> 

<xs : complexType name="GBAOneFactorContractGBAMechanismType" > 
<xs : complexContent> 

<xs : restriction base="GBAMechanismType" > 
<xs : choice> 

<xs:element ref ="LegacyGBA"/> 
<xs: element ref ="GBAMobileMobile"/> 
<xs: element ref ="GBAUICCMobile"/> 
<xs: element ref ="GBAUICCUICC"/> 
</xs : choice> 
</xs : restriction> 
</xs : complexContent> 
</xs : complexType > 

<!-- states which protocol was used between UE and NAF/IdP to authenticate the UE 
<xs : complexType name="GBAOneFactorContractAuthenticatorTransportProtocolType" > 
<xs : complexContent> 

<xs : restriction base="ac : AuthenticatorTransportProtocolType" > 
<xs : choice> 

<xs:element ref ="ac : HTTP"/ > <!-- HTTP Digest over SSL/TLS --> 
<xs:element ref ="ac :SSL"/> <!-- PSK TLS --> 
</xs : choice> 
</xs : restriction> 
</xs : complexContent> 
</xs : complexType> 

<xs : complexType name="GBAOneFactorContractIdentif icationType" > 
<xs : complexContent> 

<xs : restriction base="ac : Identif icationType" > 
<xs : sequence> 

<xs : element ref ="ac : PhysicalVerif ication"/> 
<xs : element ref ="ac :WrittenConsent"/> 

<xs:element ref ="ac :Extension" minOccurs=" 0" maxOccurs="unbounded"/> 
</xs : sequence> 
</xs : restriction> 
</xs : complexContent> 
</xs : complexType> 

</xs : schema> 
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E.4.4 GBATwoFactorContract 

This class reflects that mobile customer registration procedures have taken place and a two-factor based authentication 
of the UE is done requiring an explicit end-user interaction during authentication procedure (e.g., a PIN needs to be 
typed). 

E.4.4. 1 Associated 3GPP URI 

http://www.3gpp.org/schemas/authctx/classes/GBATwoFactorContact 

E.4.4. 2 Class schema 



<?xml version="l . 0" encoding="UTF-8" ?> 

<xs : schema targetNamespace="urn: 3gpp :gba :ac:2006-10" 
xmlns :xs="http: //www.w3 . org/2 1/XMLSchema" 
xmlns :ac="urn: liberty : ac : 2 004-12 " 
xmlns="urn: 3gpp :gba :ac:2006-10" 
finalDefault=" extension" 
version="l . 0" > 

<!-- Imports Liberty authentication context schema definitions --> 
<xs : import namespace="urn: liberty: ac:2004-12" 

schemaLocation="liberty-authentication-context-v2 . .xsd"/> 

<!-- includes 3GPP GBA Authentication Context generic definitions --> 
<xs : include schemaLocation="3gpp-gba-authentication-context-vl . .xsd"/> 

<!-- GBATwoFactorContract --> 

<xs : complexType name="GBATwoFactorContractGBAMechanismType" > 
<xs : complexContent> 

<xs : restriction base="GBAMechanismType" > 
<xs : choice> 

<xs:element ref ="LegacyGBA"/> 
<xs : element ref ="GBAMobileMobile"/> 
<xs: element ref ="GBAUICCMobile"/> 
<xs: element ref ="GBAUICCUICC"/> 
</xs : choice> 
</xs : restriction> 
</xs : complexContent> 
</xs : complexType> 

<!-- states which protocol was used between UE and NAF/IdP to authenticate the UE 
<xs : complexType name="GBATwoFactorContractAuthenticatorTransportProtocolType" > 
<xs : complexContent> 

<xs : restriction base="ac lAuthenticatorTransportProtocolType" > 
<xs :choice> 

<xs:element ref ="ac :HTTP"/> <!-- HTTP Digest over SSL/TLS --> 
<xs:element ref ="ac : SSL"/> <!-- PSK TLS --> 
</xs : choice> 
</xs : restriction> 
</xs : complexContent> 
</xs : complexType> 

<xs : complexType name="GBATwoFactorContractKeyActivationType" > 
<xs : complexContent> 

<xs : restriction base="ac : KeyActivationType" > 
<xs : choice> 

<xs : element ref ="ac :ActivationPin"/> 

<xs:element ref ="ac :Extension" maxOccurs="unbounded"/> 
</xs : choice> 
</xs : restriction> 
</xs : complexContent> 
</xs : complexType> 

<xs : complexType name="GBATwoFactorContractIdentif icationType" > 
<xs : complexContent> 

<xs : restriction base="ac : Identif icationType" > 
<xs : sequence> 
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<xs : element ref ="ac : PhysicalVerif ication"/> 
<xs : element ref ="ac :WrittenConsent"/> 

<xs:element ref ="ac : Extension" minOccurs=" 0" maxOccurs="unbounded"/> 
</xs : sequence> 
</xs : restriction> 
</xs : complexContent> 
</xs : complexType> 

</xs : schema> 
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